Index
ClickyMouse Help File

Overview Overview What Is Macro? How to…? Start Using... Adding And Editing Items Folders Running Macros Recording Macros Show / Hide User Interface Main Window Menu Drag & Drop Main Settings Item Settings Folder Settings Macro Recording Wizard Add Wizard	Commands Index Apps & Tips Mini-applications Tips Installation Automation Install add-ons Automated update Multi-users Support Special Features Data Sharing Batch Mode Lock Mode Password Protection Export / Import Others Support License Agreement


Overview

ClickyMouse software allows you to get more power from your mouse compatible device.  In standard Windows environment, you can point & click.   But there are other events you can generate with your mouse.  You can move it to screen corners, or screen edge, or you can click mouse button together with holding down CTRL and/or ALT and/or SHIFT keys, or you can shake the mouse.  If you are able to assign actions to these events you can work much faster with your mouse.  The ClickyMouse software is designed right for this purpose.  You can assign macro or a clipboard item to any of the events mentioned earlier.  Thanks to powerful build-in macro language (contains 100+ commands) the ClickyMouse allows a user to perform variety tasks including: inserting text (often used phrases, special characters, etc.),  inserting time & date, file operations, clipboard operations, FTP upload & download, windows operation, driving other apps by sending keystrokes to them, text formatting and more.

Quick features listing: unlimited number of items, copy & paste, drag & drop, find, network support, multiple users support, lock mode, password protection, macro recording (both keyboard and mouse events), application specific macros, strong scripting language with over than 100 commands (for file management, clipboard handling,  text formatting, internet/FTP access, windows manipulation, macro flow control, networking, variables manipulating and more), visual commands editing, import/export, wizards, and more...

There are some advanced macros that you can immediately use to enhance your computer use.


What Is Macro
What Is Macro ?

Macro is a sequence of actions that the user performs as one operation.  For example, if a user wants to create new e-mail message and write "Dear Customer," it requires several steps.  The user needs to click a "New message" button in e-mail client and type "Dear Customer,".   This can also be done by playing back macro.  In such case only one step is required from the user - start the macro.  It is obvious that the user can save significant portion of time if replaces often repeated tasks (typing the same phrases, doing the same file operations, writing the same reply messages, downloading the same files, etc.) by macros.  Also, the powerful build-in macro language with 100+ commands opens new horizons in extending Windows capability (multiple clipboards, for example).

Macros can contain any combination of:

•	Plain text  - Just a regular text like "Hello, how are you.".  Playing back such macro is similar to user's typing on computer keyboard.

•	Special keys  - Special keys like 'Enter',  'Page Down', etc.  Playing back such macro is similar to user's typing on computer keyboard.  Such keys are described using a special syntax (<enter>, <pgdn>).

•	Commands - Commands can perform different kinds of tasks like starting applications, opening files, manipulating windows and much more...

Thanks to visual support (each non-trivial command has its own property dialog box), it is very simple to create macros.   All the available commands are organized in easy to navigate tree.


Adding And Editing Items

Adding New Item

Before adding new item, bring main window on the screen if it is minimized to the tray icon.  There are several ways how to add a new item:

•	Use Add Wizard.  Add Wizard can be started from the main menu (or also from tray menu) and allows a user to insert all the item properties in several easy to follow steps.

•	Create new item from the scratch.  You can use "Insert / Add Macro Item" (Insert / Add Clip Item) menu item or Ctrl+I (Ctrl+L) hot key (or "Add New Macro Item" (Add New Clip Item) from a right-click menu) to bring up empty item properties dialog.

•	Create new item from template.  Any of existing item can be marked as a "template" ("Use this item as template" option in item properties dialog box, "Options" tab).  This allows a user to create his/her own template that can be easily selected from dialog box.  To create new item from a template use "Insert / Create From Template" menu item or Ctrl+T hot key (or "Create From Template" from a right-click menu).

•	Record new macro.

Editing Macro

To edit macro, open the item settings dialog box and go to the "Macro" tab.
The window with all the commands available will show automatically next to the item settigs window.  To add new command just select the one you want in the tree and click either "Add" or "Insert" button.  Each command has its own dialog box for specifying parameters.  After pressing OK button the command is added/inserted to the macro.
To edit command just click on the command and press "Edit" button.

Macro can be viewed/edited in two different modes:

•	Raw source text - the macro is displayed and edited as a text.

•	Formatted - the macro is displayed in the list view.  Each command is in a separate row with its icon.

The "edit" button is available in both the modes.


Folders

The folders makes it simple for user to organize items into logical groups and navigate among them easily.  Each folder has its own settings and some of them influence the items behavior:

•	Password protection.  If you want to have items password protected then specify the password in the folder settings.

•	Items specific to particular window.   If you want to have some shortcuts to work only in particular windows then specify such windows in the folder settings.

•	Font used in the "Item Properties" dialog box.  If you want to use different font in the "Macro" editor box then specify the font in the folder settings.

Folders can be moved using drag & drop, right-click menu is supported.


Running Macros

User defines the way how the macro will be started  in the items settings dialog box. The user can select from variety mouse events that can be combined with CTRL, ALT and SHIFT keyboard keys.   Except that, the user can run macro directly from the program.  There are these options available:

•	Tray Menu
The user can right click on the tray icon and select from items listed on the top of the menu shown.  There are listed only items that user previously marked (in the Items Settings) to be added to tray menu.

•	Main Window
The macro can be started from the main window using either toolbar button or "Tools/Run Macro" menu item.  Because all items are organized logically in folders it is easy to find desired item.

•	All Items Listing Window
The user can right click on the tray icon and select "All Items List" menu item.  In the dialog box shown there are listed all the items that user can select and run.

•	From Link
The user can create "Desktop Shortcut" (menu item "Tools / Create Desktop Shortcut") to an item and run the macro by double-clicking on the desktop shortcut.

•	Drag & Drop
You can drag an item in  the main window and drop it on a window you want to run the macro in.

The red color on the tray icon signalizes that the macro is running.  To stop running macro, press Shift+Escape hot-key.


Recording Macros

Recording is other way how to create macro.  It allows you to record the particular sequence of keystrokes and mouse events you do.  Just start macro recording wizard (menu item "Insert / Record Macro" or Ctrl+R hot key), specify all the recording options in a few easy to follow wizard steps and press "Record Now!" button.  Now you can type, press hot-keys, move and click mouse and all your activities are recorded in the memory.  When you are done you can click "Stop" button in the small window in lower-right corner of the screen or press hot-key that is defined in main settings window.


Show And Hide Main Window

When the program is running there is its  icon in the Taskbar tray area.  Left mouse button click on the icon causes that the main window is activated and shown on the screen (if it was previously minimized).  There is also user-defined hot key (can be set in the main settings window) that can be used to show/hide main window from keyboard.


Main Window

The main window has a look & feel very similar to Windows Explorer so it is very easy to master it even for novices.  The window consists of three panes:  Folders view (the tree on the left), Items view (upper-right part of the window) and Preview (lower-right part of the window).

Folders can be re-arranged using drag & drop and each folder can have unlimited number of subfolders.  Right click on a folder displays context menu with folder operations available.  Double click on folder will bring up folder settings window.

When a folder is selected associated items are shown in the items view.  Items can be sorted by clicking on the particular column header.  The order of the items can be changed using drag & drop.  You can use drag & drop also for copying/moving item(s) to another folder.  Right click on an item displays context menu with item operations available.  Double click on item  will bring up item settings window.  The macro text of the selected item is shown in the preview pane.

There are  two different toolbars available for users:  Simple - with just the basic a few buttons (on the figure above) and Complete - with much more buttons (can be turn on by "View / Complete Toolbar" menu item).

Read here about each menu item.

If the window is minimized then it is totally hidden to the user just tray icon remains in the Taskbar.  Click on the tray icon to show the window on the screen.


Menu

Main Menu

File

•	New - creates new empty file

•	Open - opens an existing file.

•	Insert File - opens an existing file and inserts it to the currently opened file as a new folder.  This way can the user combine different files.

•	Save - saves all the changes to currently opened file.

•	Save As - saves currently opened file under a different name (makes a copy).

•	Items Listing - creates text file (specially formatted) of all the items in the file.  File of this format can be imported to a folder by folder menu command "Import From Listing".

•	Exit - terminates the program.

Edit

•	Edit - brings up the folder settings or item settings dialog box (depending on what is selected).

•	Copy - copies selected folder or item(s) to the programs internal clipboard.

•	Paste - pastes previously copied object from the internal clipboard.

•	Delete - deletes selected object(s) (folder or item(s)).

•	Find Item - shows list of all the items available.

•	Find Text - shows the dialog window that allows you to search for an item containing required string.  The searching is text sensitive.

View

•	Simple Toolbar - if checked, the simple toolbar is shown.

•	Complete Toolbar - if checked, the complete toolbar is shown.

Insert

•	Add Wizard - starts add wizard..

•	Add Folder - adds a new folder.

•	Add Macro Item - creates new empty macro item.

•	Add Clip Item - creates new empty clip item.

•	Create From Template - creates new item from template the user selects.

•	Record Macro - starts macro recording.

Tools

•	Mouse Properties - displays standard Windows "mouse properties" dialog box.

•	Run Macro - starts selected macro.

•	Create Desktop Shortcut - creates a shortcut to the selected item on the desktop.

•	View Log File - shows the log file.  For each macro started, there is a record with the name, start time and end time.

•	Save Clipboard Data To File - saves clipboard content to a file (in all the formats available).  The file can be used in the <clpload> command.

•	Load Clipboard Data From File - loads clipboard data from file and puts them to the clipboard (so that the clipboard content is changed after this operation).

•	Options - opens the main settings dialog box.

Security

•	Lock Mode - turns the program to a special mode in which no change can be made.  The lock mode can be password protected and is good in a case you want to make sure that the user of the program cannot make any changes.

Help

•	Contents - shows the main help page.

•	Commands Index - shows commands help.

•	Home Page - opens Pitrinec Software web page.

•	Register - allows the user to register product.

•	About - displays "About" box.

Tray Menu

In the begin of the menu, there are listed items the user made available from the tray menu.  The option that allows to add/remove items to the tray menu can be found in the item settings window.

•	Hide - hides/shows the main window.

•	DeActivate - if checked, the program is deactivated and doesn't react to text shortcut or key shortcut.

•	Settings - shows the main settings dialog box.

•	Save - saves all the changes to the currently opened file.

•	Add Wizard - starts add wizard..

•	Record Macro - starts macro recording.

•	All Items List - shows a list of all the items available.  User can either run or edit any item from the list.

•	Exit - terminates the program.

Folder Menu

•	Add sub-folder - creates new folder as a child of the currently selected folder.

•	Add folder - creates new folder as a sibling of the currently selected folder.

•	Copy - copies the selected folder (without items) to the internal clipboard.

•	Paste - pastes previously copied folder.

•	Delete - deletes selected folder (including all the items).

•	Items Listing - creates text file (specially formatted) consisting of the items from the selected folder.  File of this format can be imported to other folder by Import From Listing.

•	Import From Listing - imports items from text file to the currently selected folder.  The text file was previously created by Items Listing command (or has the same formatting).

•	Properties - opens folder settings window.

Item Menu

•	Run - starts macro.

•	Add New Macro Item - creates new empty item.

•	Add New Clip  Item - creates new empty item.

•	Create From Template - creates a new item from the template user selects.

•	Copy - copies selected item(s) to the internal clipboard.

•	Paste - pastes copied item(s).

•	Delete - deletes selected item.

•	Properties - shows item settings dialog box.


Drag & Drop

There are several areas when user can use drag & drop techniques to easily perform desired task:

•	Copy/Move item(s) from one folder to another.

•	Move folder to a different location.

•	Order items in the items view.

•	Run macro in a window.


Main Settings

To access the main settings dialog window select "Tools / Options" main menu item.
Main Settings - General:

•	Find Item - hot key that brings up window with list of all items.

•	Activate / deactivate - hot key to activate or deactivate program.

•	Start / stop macro recording - hot ket to start macro recording.

•	Show / hide - hot key to show or hide main window.

•	Play sound when executing macro - if checked, defined sound (.wav file) is played when macro is started.

•	Send  macro keystroke fast - if checked, the keystrokes (when playing back the macro) are send to destination window without any delays.  This option can be programatically changed within each macro using <faston> and <fastoff> commands.

•	Save settings on exit - if checked, all the changes made in settings, window position, etc. is saved on the programs exit.

•	Show tips - if checked, tips are showing during working with the program.

•	Always start minimized to tray - if checked, the program always starts minimized to the Taskbar tray icon.  Otherwise the program starts in the same position as it was before exiting.

•	Start automatically on Windows Startup - if checked the programs automatically loads on Windows startup.

•	Log macro execution - if enabled, the start & stop macro execution time is added to the log.txt file.  The file is available from the "Tools / View Log File" main menu item.

•	Allow shared items - if checked, multiple users on network can share items saved in the file specified in "shared file path" field.

•	Shared file path - the to the file with shared items.

Main Settings - ClickyMouse:

•	Automatically activate ... - if checked, the ClickyMouse will automatically activate window with the mouse cursor (so that it is not necessary to click on it to activate it).

•	Auto scrolling - if checked, special auto scrolling feature is enabled.  To scroll larger documents using this feature follow this:
1. Within the document, press right (middle) mouse button and hold it down.
2. Move the mouse cursor up/down within the document while still holding the mouse button down.  The document should scroll.
3. Release the mouse button when you want to stop the scrolling.
This feature will make scrolling documents easier even if you do not have a wheel mouse.

•	Show mouse cursor position - if checked, small window displaying the actual mouse cursor position is shown.  The window displayes the mouse coordintae either in absolute screen coordinates or in coordinates relative to the currently active window.


Item Settings

There are two types of items:  Macro items and clip items.  While macro item allows you to perform variety of different tasks (from simple text inserting or starting application to complex scripts) clip item allows you just one thing: pasting clipboard data.  Using clip items you can simply insert pictures, formatted texts, tables or charts to Windows applications. To access item properties double-click on an item in the main window.

General:

•	Name - the name of the item is used just for your easy navigation.

•	Description - description of the item.

•	Change icon - allows to select/change icon.

•	Disable - if checked, the item is disabled and user is not able to run it using a mouse event defined in "Event" part of the window (see below).

Events:

Mouse Event:

•	Mouse click - user can select from left, middle or right mouse button click either anywhere on the screen, or anywhere within a window, or on the window's title bar, or on desktop or on the Taskbar.

•	Shake mouse horizontaly - user quickly moves mouse from left to right and back several times.  The user can define if the mouse should be anywhere on the screen or in upper/middle/lower area of the screen.

•	Shake mouse vertically - user quickly moves mouse from top to bottom and back several times.  The user can define if the mouse should be anywhere on the screen or in left/middle/right area of the screen.

•	Move mouse to screen edge - the user can select from left, right, upper and bottom screen edge.

•	Move mouse to screen corner - the user can select from upper-left, upper-right, bottom-left and bottom-right corner.

•	None - no event is defined (the macro can be executed from the program, see running macros).

Control keys:

Alt, Ctrl and Shift key can be used together with the mouse event specification above.

Example:  The user can specify, for example, this: "run macro if the user clicks (left button) on the Taskbar while holding Alt key pressed".

If the event specified here occurs the associated macro is started.

Macro:
In this section, the user can edit macro. If the item was created as a "clip  item" this page is not available.

•	Macro - define the macro you want to run here.  Just type the macro text in or use "Add/Insert" buttons of the " Available Commands" window.  Depending on the "Raw source text / Formatted" switch the macro is displayed as plain text or sequence of steps.

•	Raw source text - if selected, the macro is displayed as a plain text and can be edited as any other text.

•	Formatted - if selected, the macro is displayed as a sequence of steps (commands).

•	Edit - allows to visually edit command.

•	|< << >> >| - use these arrows for navigation in macro.

•	Up - moves the macro steps one row up (only if "formatted" macro view).

•	Down - moves the macro steps one row down (only if "formatted" macro view).

•	Copy -  copies selected macro step (only if "formatted" macro view).

•	Delete - deletes selected macro step (only if "formatted" macro view).

•	Other / Insert recorded macro - inserts macro recorded in the memory.

•	Other / Remove timing commands - removes timing commands <wx> from the macro.  These commands are in the macro if user records macro with real time information.

•	Other / Remove mouse move commands - removes mouse move commands <mm> from the macro.  These commands are in the macro if user records macro with mouse move information.

•	Available Commands - all the available commands organized in the tree.  Just select the command in the tree and press "Add" (adds the command to the end of macro) or "Insert" button.  This window appears automatically when "Item Properties - Macro" page is selected.

Clip:
Insert clipboard data.  If the item was created as a "macro item" this page is not available.

•	Paste -click this button to insert data from the clipboard to the item.

•	Copy - click this button to copy data from the item to the clipboard.

Options:
In this section, there are additional options the user can set for each item.

•	Pass text through clipboard - if the macro is just a text with no commands or special keys then it can be inserted to the destination window through the clipboard.  It is faster especially if the text is bigger.   If this option is checked and the macro contains commands then the commands are not executed.

•	Playback macro - user can control the playback speed of macro if it contains wait commands (usually recorded macros).

•	Repeat macro - how many times should be the macro repeated.

•	Run macro in separate process - during the macro execution no other macro can start.  This is not convenient for macros that can take very long to finish (for example, FTP download).  In such case there is an option to start time consuming macro in separate process so that it doesn't block other macros from starting.

•	Add to tray menu - if checked, the item is available in the tray menu.

•	Run this macro on the program startup - if checked, the macro is automatically executed when the program starts.

•	Use this item as template - if checked, this item is available in the list of templates that can be used to create new items.


Folder Settings

To access folder properties double-click on a folder in the main window.

Folder Properties - General:

•	Label - the name of the folder.

•	Description - user can put any description or notes here.

•	Password - user can password protect items from this folder.

•	Change icon - button to select/change icon.

Folder Properties - Applications:
Items from this folder can be specific to selected applications (windows).

•	Items from this folder works in applications:
All - items work in all applications
Listed below only - items work only in the windows with the listed titles
Not listed below - items work only in the windows not listed

•	Application window titles - title of the window goes to each row.  The title can be just a partial string.  The case (uppercase or lower case) doesn't play a role.
There is a special syntax when specifying window title.  This syntax allows more exactly determine window.  The syntax is:
child window title///main window title
or
window title
or
///window title

For example, if you specify "find///notepad" then the item will work only in the "Find" dialog of "Notepad" application.  If you specify just "find" the will work in "Find" dialog of any application.  If you specify "///notepad" the item will work in "Notepad" window and all its child windows including "Find" dialog.

Folder Properties - Advanced:
The user can select font that will be used for items from this folder in item settings dialog box.


Macro Recording Wizard

Macro recording wizard allows you to define your recording options in a few logical and easy to follow steps.  If you want to start recording with options already defined from a previous recording just press "Record Now!" button in any wizard step.
To open macro recording wizard select "Insert / Record Macro" menu item in the main window or press hot key defined in the main settings or select "Record Macro" in the tray menu.

1. Select events to record:
In this step, the user can select what events (mouse or keyboard or both) should be recorded and some of the associated options.

•	Keyboard - if checked, all keyboard events (keystrokes) are recorded.

•	Mouse - if checked, all mouse clicks are recorded.

•	Record mouse movements - if checked, mouse movements are recorded so that it easy to see the mouse cursor position when playing macro back.  The size of macro recorded is much bigger.

•	Mouse coordinates - specifies if mouse coordinates is relative to:
1. Screen
2. Active Window
3. Current mouse position

•	Record real time information - if checked, the real time information is saved during macro recording.  In such the case, user can define the macro playback speed in the item settings dialog window.

2. Select where to save macro when recording is finished:
In this step, the user defines what to do with the macro recorded.

•	Record macro to memory - the macro is recorded into the memory and can be inserted later to any item in item settings window.

•	Add new item to the currently selected folder - new item is added to the current folder.

•	Insert macro to the currently selected item - macro of the currently selected item is overwritten by the new one recorded.

•	Add new item to this folder - new item is added to the defined folder.

•	Insert macro to this item -  macro of the defined item is overwritten by the new one recorded.

3. Select a window you want to activate before macro playback:

•	None - the macro playback will start in the currently active window.

•	Default window - window specified is activated before macro playback starts.

•	Capture window - the window to activate is captured on the start of macro recording (the window where first keystroke or mouse click occurs).

•	Enter or select window - window specified is activated before macro playback starts.

All the recording options are defined now and the macro recording can be started.


Add Wizard

Add wizard allows you to create new item in a few easy to follow steps.  To start add wizard select "Insert / Add Wizard" menu item in the main window or select "Add Wizard" in the tray menu.

1. Select Action:
Select either macro or clip item here.  Select from mostly used commands or create (record) other kind of macro.

2. Define Mouse Event:

Mouse Event:

•	Mouse click - user can select from left, middle or right mouse button click either anywhere on the screen, or anywhere within a window, or on the window's title bar, or on desktop or on the Taskbar.

•	Shake mouse horizontaly - user quickly moves mouse from left to right and back several times.  The user can define if the mouse should be anywhere on the screen or in upper/middle/lower area of the screen.

•	Shake mouse vertically - user quickly moves mouse from top to bottom and back several times.  The user can define if the mouse should be anywhere on the screen or in left/middle/right area of the screen.

•	Move mouse to screen edge - the user can select from left, right, upper and bottom screen edge.

•	Move mouse to screen corner - the user can select from upper-left, upper-right, bottom-left and bottom-right corner.

•	None - no event is defined (the macro can be executed from the program, see running macros).

Control keys:

Alt, Ctrl and Shift key can be used together with the mouse event specification above.

Example:  The user can specify, for example, this: "run macro if the user clicks (left button) on the Taskbar while holding Alt key pressed".

If the event specified here occurs the associated macro is started.

3. General Settings:

•	Name - the name of the item is used just for your easy navigation.

•	Description - description of the item.

•	Change icon - allows to select/change icon.

4. Select Folder:

In the last step the user can select the folder where the new item should be saved..

Please note that there are more settings that can be set for each item.  The add wizard is intended for novice users and therefore is simplified.   To access all the options go to the item settings dialog window.


Mini-applications

Mini-application is a macro (or set of macros) -- designed to do one particular thing -- that anybody can immediately start using without any effort.  There are several mini-applications that you can download and add to your current ClickyMouse functionality.  Please, click here to get mini-applications from our web site.


Tips

Please, click here to access ClickMouse tips & tricks on our web site.


Data Sharing

Network users can share items over the LAN network. Shared shortcut items are saved in a special file that has to be located on a network drive (directory) all user can access. Each user wanting to use shared items has to enable "Allow shared items" option and specify the path to the shared items file in the main settings window.

Shared Items File Editing

To create a shared items file, create a new file selecting "File/New" menu item. Name the new file so that the name is different than other files users use (for example, "SharedItemsFile"). Edit the file (create folders and shortcut items) and save it on shared network drive on the network. When the shared shortcut items file is created all the users will see "Shared Items" folder in their folder view.

Note the shared items can be edited only when shared items file is directly opened in the program using "File / Open".  This means that if a user (administrator) wants to make changes to shared items he/she has to open shared items file by selecting the file in file open dialog ("File/Open").


Batch Mode

The program can run also in "batch mode". This means that it is started with the parameters specifying what macro from what file should be performed.  The program is started so that the UI is hidden and after the macro execution is finished the program is unloaded from the memory.  This way you can start macros from Windows desktop, Windows Explorer or other tools.

Syntax:

"C:\Program Files\....\....exe" -run:text_shortcut File_path

If you create item shortcut on the desktop using "Tools / Create Desktop Shortcut" command from the main menu you can see the syntax in the shortcut properties.


Server Installation & Multi-users Support
Multi-users Support

Automated Update

It is possible to install the software to each users’ machine on the network while effort necessary to update the software on each machine is minimized.  For example notebook users, when connect to the company network and start the software it is automatically updated from server.

Read more…

Server Installation

The program can keep multiple users settings while it is installed just once on the computer.  This feature allows multiple users share one installation on the network server (or local machine) and minimize disk space required and maintenance effort (makes upgrading easy even if there are many users on the net).

Information about all the users are stored in the users.ini file that resides in the same directory where the product is installed.  The file is a text file that can be edited by any raw text editor like Notepad.  The file structure is as follows:

[header]
num_of_users=2

[1]
name=oscar
path=\\server\users\oscar

[2]
name=debie
path=\\server\users\debie

Note:  The path name may not end with \ character!   The [1], [2], etc., sections have to start by [1] and end by [num_of_users].   The number of users is limited by your license.

Starting Program

There are two ways how to start the program with user's settings loaded:

1.	PATH_TO_THE PROGRAM /user:?
Where the PATH_TO_THE PROGRAM is full path to the software executable.  When the program starts with this "/user:?" parameter a login dialog expecting user name (from the users.ini file above) to be inserted appears.

2.	PATH_TO_THE PROGRAM /user:USER_NAME
Where the PATH_TO_THE PROGRAM is full path to the software executable and USER_NAME is the user name from the users.ini file above.  This will start the program without any login dialog.

Adding New User

To add new user follow these steps:

1.	Create new user's directory where the program can save settings and data files.  You can create a copy of the "UserDir-Template".

2.	Increase the number of users in [header] section of users.ini file.

3.	Add new user section (for example, [10] if there are ten users) and specify users name and the user's directory path (as per 1 above):

[10]
name=hugo
path=\\server\users\hugo

4.	On the user's workstation, create a link to the executable command line as described in "Starting Program" section above.


Lock Mode

The program can be switched to the mode in which no settings can be changed (items settings, folder settings, main settings).  This mode can be used in the case when administrator wants to make sure that the user will not make changes in the program.  The lock mode is password protected.

Lock mode is available from the main menu through the "File / Lock Mode" menu item.

Please note that the lock mode is something different from the password protection.


Password Protection

There is an option to password protect items so that no one who doesn't know the password can see the macro text, edit item or run it.  The password protection is implemented on the folder level.  This means that user defines password for the given folder and all the items from the folder are password protected.   Go to the folder settings window and press "Password" button.

•	Password - type your desired password here.

•	Confirm password - retype the password to make sure you didn't mistype.

•	Require password: Always - the password is required any time you want to run or edit password protected item.

•	Require password: When there was no an activity... - the password is required only if there wasn't mouse or keyboard activity for longer than the given time.

•	Enable - if checked, the password protection is activated.


Export / Import

The program allows to export / import data to / from text file.  The text file has to have special format so that import can work properly.

Export

Either whole the file data (using "File / Items Listing" menu item available from main window) or just data from the given folder (by the "Items Listing" command from the folder menu) can be exported.

Import

The text file previously created by "Items Listing" command can be imported using folder menu command "Import From Listing".

Please, keep in mind that this feature is intended for the basic import/export needs and not all item's attributes are imported/exported.


Support

Support is provided on support@pitrinec.com and is FREE for all the registered users.

When reporting bugs or problems please include:

•	Your name:

•	Your e-mail:

•	Registration number:

•	Program name:

•	Program version:

•	Operating system (Win95/98/2000/NT):

•	PC configuration (Processor, RAM):

•	Problem description:

Note:  If the problem may be related to the data (macros) you have created send also data file (by default located in the same directory where the program is installed) and options.ini file.

Please, keep in mind that more information you provide us about your problem give us better chance to find a solution.


License Agreement

Upon your acceptance of this Agreement, Pitrinec Software (Author) grants to you a nonexclusive license to use the ClickyMouse software (Software).

1.Use of the Software.

The Software has been released for distribution as a SHAREWARE and may be distributed at no cost.

You are granted a license to try the Software for 30 days. After this time, the Software must be registered or removed from the system.

You may install the Software on a hard disk or other storage device; install and use the Software on a file server for use on a network for the purposes of (i) permanent installation onto hard disks or other storage devices or (ii) use of the Software over such network; and make backup copies of the Software.

2.Restrictions.

Unregistered use of the Software after the 30-day evaluation period is in violation of international copyright laws.

You are not allowed to modify, translate, reverse engineer, decompile, disassemble or otherwise attempt to discover the source code of the Software.

The number of the (licensed) Software instances running at the same time may not exceed the number of licenses purchased.

You are not allowed to redistribute or provide to 3rd party already registered versions of the Software as well as you may not publish the registration number(s) that unlock the Software.

The Software can be distributed only as the package provided by the Author. This package cannot be changed in any way without written Author's permission.

3.No Warranty.

ALL WARRANTIES ARE DISCLAIMED, WHETHER EXPRESSED OR IMPLIED, IN THIS SOFTWARE. THE ENTIRE RISK OF THE USE OR THE RESULT OF THE USE OF THIS SOFTWARE REMAINS WITH THE USER.

Unpublished-rights reserved under international copyright laws.


Commands Tree

Commands tree shows all the commands available.  The commands tree window shows automatically when "Macro" tab is selected in the "Item Properties" dialog box.  Use "Add"/"Insert" button to add/insert desired command to the macro.


Install customization
Install add-ons

It is possible to add your own files to the installation.  There is “Custom” directory where you can add any file that should be part of the installation.  The “Custom” directory from the installation set is copied as it is to the destination folder on workstation.  This allows administrators to add their own data files, help files, etc. to the installation.


Install automation

It is possible to pre-define any of the installation options including destination folder, registration number, program group, etc.

Custom values of all the options are defined in the admin.ini, file [setup] section, from the installation package.  Use these keys to set custom values of installation options:

folder 	– destination folder

group 	– group in Start menu

serverpath 	– path to network directory that will be used as a source for automated software update

admindb 	– path to a network directory where administration database resides

datafile 	- name (full path) of the data file that should be loaded automatically on the program startup

loginuser 	- username of the user to automatically login on the program startup

regnum	- the programs registration number

user	- the name of the user the program is registered to

company	- the name of the company the program is registered to

If an administrator wants to pre-define some of the installation settings just follow these steps:

1.  Open admin.ini file in Notepad.

2.  Add [setup] section if it doesn’t exist yet.

3.  Add a key from the above and define its value (for example, folder=c:\program files\toolsworks).

4.  Save the admin.ini file.

The file should look like this (example):

[setup]

folder=c:\program files\toolsworks

regnum=XXX-YYY-ZZZ

It is also possible to disable some of the setup pages from showing.  For example, if an administrator pre-defines registration information it is not necessary to show this page during the setup process.  There are these keys available to disable each of the setup page:

pg_welcome	- initial “welcome” page

pg_licensetxt	- license text page

pg_choosefolder	- choose folder page

pg_regnum	- registration information page

pg_startup	- advanced options page

pg_selectgroup	- choose program group page

pg_startcopy	- “start copy” page

pg_complete	- complete setup page

These keys are from [setup] section as well.  To disable any of the page above assign the key “no” value.

For example, to disable welcome page the admin.ini file should contain this:

[setup]

pg_welcome=no


Automated update

In the network environment, it is possible to define a network directory that is used as a server for software update.  On the program startup, the software version on the workstation is compared with the software version on the network and if a newer version is available, it is automatically updated.

This feature allows administrator to manually update software only on one computer (the network directory) and all other installations on other workstations are updated automatically.

To enable this feature, you have to follow this:

1.  Install the program on a network directory all users can access from their workstations.

2.. When installing the software on a workstation, make sure that you define the network directory in “Path to a server to update software from:” field.

Administrator can define which files should be updated.  The automated update information are saved in the options.ini file, in the [update] section.  There are these keys:

files 	– the names of files to update delimited by ;  Wild chars (*?) are allowed.

dirs 	– the names of directories to update delimited by ;  Wild chars (*?) are allowed.

verid 	- the program (package) id.  This id is changed by the program vendor when a new version is released.  But also administrator can change this id in order to update clients installations when a custom file was changed, for example.

Example:

[update]

verid=pitrinec_4.50

files=*.exe;*.dll;*.gif;*.ico;*.htm;

dirs=help;custom